Skip to content

Chore/improve error handling#7835

Merged
lwin-kyaw merged 14 commits intomainfrom
chore/improve-error-handling
Feb 10, 2026
Merged

Chore/improve error handling#7835
lwin-kyaw merged 14 commits intomainfrom
chore/improve-error-handling

Conversation

@lwin-kyaw
Copy link
Contributor

@lwin-kyaw lwin-kyaw commented Feb 4, 2026

Explanation

Current errors from SubscriptionService lack enough context for Sentry, making it hard to diagnose failures. This change enriches SubscriptionServiceError with additional error details (e.g., HTTP status and response info) and improves error handling paths so those details are preserved and surfaced.

BREAKING: This PR also adds two new params, captureException and fetchFunction to SubscriptionService constructor args.

  • fetchFunction is to use the client provided Fetch API.
  • captureException is to capture the error thrown and report to Sentry. This is to isolate the Subscription APIs errors reported to Sentry.

References

Related to MetaMask/metamask-extension#39432. This won't fix the underlying issue (which is still TBD) but it adds more helpful info for the debugging.

Checklist

  • I've updated the test suite for new or updated code as appropriate
  • I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
  • I've communicated my changes to consumers by updating changelogs for packages I've changed
  • I've introduced breaking changes in this PR and have prepared draft pull requests for clients and consumer packages to resolve them

Note

Medium Risk
Touches all Subscription Service network calls and error propagation, and introduces a breaking constructor change that all consumers must update; failures could change runtime error behavior if integrations don’t pass compatible fetch/Sentry handlers.

Overview
BREAKING: SubscriptionService now requires a fetchFunction and optionally accepts captureException, replacing the internal handleFetch usage.

Request handling is refactored to validate URL construction, parse non-2xx HTTP responses into structured error messages (status/body/errorCode), attach underlying causes to SubscriptionServiceError, and include request URLs for better Sentry diagnostics; a small logger wrapper is added.

Adds SubscriptionServiceErrorMessage constants plus SubscriptionApiError type exports, and expands/adds tests to cover network vs non-ok responses, non-Error throws, auth token failures, URL construction failures, and controller surfacing of triggerAccessTokenRefresh errors.

Written by Cursor Bugbot for commit f06b61b. This will update automatically on new commits. Configure here.

@lwin-kyaw lwin-kyaw requested a review from a team as a code owner February 4, 2026 12:04
@lwin-kyaw lwin-kyaw requested a review from a team as a code owner February 4, 2026 13:18
@lwin-kyaw
Copy link
Contributor Author

@metamaskbot publish-preview

@github-actions
Copy link
Contributor

github-actions bot commented Feb 4, 2026

Preview builds have been published. See these instructions for more information about preview builds.

Expand for full list of packages and versions.
{
  "@metamask-previews/account-tree-controller": "4.0.0-preview-8f3469e9c",
  "@metamask-previews/accounts-controller": "35.0.2-preview-8f3469e9c",
  "@metamask-previews/address-book-controller": "7.0.1-preview-8f3469e9c",
  "@metamask-previews/ai-controllers": "0.0.0-preview-8f3469e9c",
  "@metamask-previews/analytics-controller": "1.0.0-preview-8f3469e9c",
  "@metamask-previews/analytics-data-regulation-controller": "0.0.0-preview-8f3469e9c",
  "@metamask-previews/announcement-controller": "8.0.0-preview-8f3469e9c",
  "@metamask-previews/app-metadata-controller": "2.0.0-preview-8f3469e9c",
  "@metamask-previews/approval-controller": "8.0.0-preview-8f3469e9c",
  "@metamask-previews/assets-controller": "0.1.0-preview-8f3469e9c",
  "@metamask-previews/assets-controllers": "99.2.0-preview-8f3469e9c",
  "@metamask-previews/base-controller": "9.0.0-preview-8f3469e9c",
  "@metamask-previews/bridge-controller": "65.2.0-preview-8f3469e9c",
  "@metamask-previews/bridge-status-controller": "65.0.1-preview-8f3469e9c",
  "@metamask-previews/build-utils": "3.0.4-preview-8f3469e9c",
  "@metamask-previews/chain-agnostic-permission": "1.4.0-preview-8f3469e9c",
  "@metamask-previews/claims-controller": "0.4.2-preview-8f3469e9c",
  "@metamask-previews/composable-controller": "12.0.0-preview-8f3469e9c",
  "@metamask-previews/connectivity-controller": "0.1.0-preview-8f3469e9c",
  "@metamask-previews/controller-utils": "11.18.0-preview-8f3469e9c",
  "@metamask-previews/core-backend": "5.1.0-preview-8f3469e9c",
  "@metamask-previews/delegation-controller": "2.0.0-preview-8f3469e9c",
  "@metamask-previews/earn-controller": "11.1.0-preview-8f3469e9c",
  "@metamask-previews/eip-5792-middleware": "2.1.0-preview-8f3469e9c",
  "@metamask-previews/eip-7702-internal-rpc-middleware": "0.1.0-preview-8f3469e9c",
  "@metamask-previews/eip1193-permission-middleware": "1.0.3-preview-8f3469e9c",
  "@metamask-previews/ens-controller": "19.0.2-preview-8f3469e9c",
  "@metamask-previews/error-reporting-service": "3.0.1-preview-8f3469e9c",
  "@metamask-previews/eth-block-tracker": "15.0.1-preview-8f3469e9c",
  "@metamask-previews/eth-json-rpc-middleware": "23.1.0-preview-8f3469e9c",
  "@metamask-previews/eth-json-rpc-provider": "6.0.0-preview-8f3469e9c",
  "@metamask-previews/foundryup": "1.0.1-preview-8f3469e9c",
  "@metamask-previews/gas-fee-controller": "26.0.2-preview-8f3469e9c",
  "@metamask-previews/gator-permissions-controller": "1.1.2-preview-8f3469e9c",
  "@metamask-previews/json-rpc-engine": "10.2.1-preview-8f3469e9c",
  "@metamask-previews/json-rpc-middleware-stream": "8.0.8-preview-8f3469e9c",
  "@metamask-previews/keyring-controller": "25.1.0-preview-8f3469e9c",
  "@metamask-previews/logging-controller": "7.0.1-preview-8f3469e9c",
  "@metamask-previews/message-manager": "14.1.0-preview-8f3469e9c",
  "@metamask-previews/messenger": "0.3.0-preview-8f3469e9c",
  "@metamask-previews/multichain-account-service": "5.1.0-preview-8f3469e9c",
  "@metamask-previews/multichain-api-middleware": "1.2.6-preview-8f3469e9c",
  "@metamask-previews/multichain-network-controller": "3.0.2-preview-8f3469e9c",
  "@metamask-previews/multichain-transactions-controller": "7.0.0-preview-8f3469e9c",
  "@metamask-previews/name-controller": "9.0.0-preview-8f3469e9c",
  "@metamask-previews/network-controller": "29.0.0-preview-8f3469e9c",
  "@metamask-previews/network-enablement-controller": "4.1.0-preview-8f3469e9c",
  "@metamask-previews/notification-services-controller": "21.0.0-preview-8f3469e9c",
  "@metamask-previews/permission-controller": "12.2.0-preview-8f3469e9c",
  "@metamask-previews/permission-log-controller": "5.0.0-preview-8f3469e9c",
  "@metamask-previews/perps-controller": "0.0.0-preview-8f3469e9c",
  "@metamask-previews/phishing-controller": "16.1.0-preview-8f3469e9c",
  "@metamask-previews/polling-controller": "16.0.2-preview-8f3469e9c",
  "@metamask-previews/preferences-controller": "22.1.0-preview-8f3469e9c",
  "@metamask-previews/profile-metrics-controller": "3.0.0-preview-8f3469e9c",
  "@metamask-previews/profile-sync-controller": "27.0.0-preview-8f3469e9c",
  "@metamask-previews/ramps-controller": "6.0.0-preview-8f3469e9c",
  "@metamask-previews/rate-limit-controller": "7.0.0-preview-8f3469e9c",
  "@metamask-previews/remote-feature-flag-controller": "4.0.0-preview-8f3469e9c",
  "@metamask-previews/sample-controllers": "4.0.2-preview-8f3469e9c",
  "@metamask-previews/seedless-onboarding-controller": "7.1.0-preview-8f3469e9c",
  "@metamask-previews/selected-network-controller": "26.0.2-preview-8f3469e9c",
  "@metamask-previews/shield-controller": "5.0.1-preview-8f3469e9c",
  "@metamask-previews/signature-controller": "39.0.1-preview-8f3469e9c",
  "@metamask-previews/storage-service": "1.0.0-preview-8f3469e9c",
  "@metamask-previews/subscription-controller": "5.4.2-preview-8f3469e9c",
  "@metamask-previews/transaction-controller": "62.14.0-preview-8f3469e9c",
  "@metamask-previews/transaction-pay-controller": "12.1.0-preview-8f3469e9c",
  "@metamask-previews/user-operation-controller": "41.0.2-preview-8f3469e9c"
}

@lwin-kyaw lwin-kyaw force-pushed the chore/improve-error-handling branch from 86087f4 to 8ddac2e Compare February 4, 2026 16:36
tuna1207
tuna1207 previously approved these changes Feb 5, 2026
@lwin-kyaw lwin-kyaw added area-shield Transaction Shield team-shield labels Feb 5, 2026
@lwin-kyaw
Copy link
Contributor Author

@metamaskbot publish-preview

@github-actions
Copy link
Contributor

github-actions bot commented Feb 5, 2026

Preview builds have been published. See these instructions for more information about preview builds.

Expand for full list of packages and versions.
{
  "@metamask-previews/account-tree-controller": "4.0.0-preview-843a84316",
  "@metamask-previews/accounts-controller": "35.0.2-preview-843a84316",
  "@metamask-previews/address-book-controller": "7.0.1-preview-843a84316",
  "@metamask-previews/ai-controllers": "0.0.0-preview-843a84316",
  "@metamask-previews/analytics-controller": "1.0.0-preview-843a84316",
  "@metamask-previews/analytics-data-regulation-controller": "0.0.0-preview-843a84316",
  "@metamask-previews/announcement-controller": "8.0.0-preview-843a84316",
  "@metamask-previews/app-metadata-controller": "2.0.0-preview-843a84316",
  "@metamask-previews/approval-controller": "8.0.0-preview-843a84316",
  "@metamask-previews/assets-controller": "0.2.0-preview-843a84316",
  "@metamask-previews/assets-controllers": "99.2.0-preview-843a84316",
  "@metamask-previews/base-controller": "9.0.0-preview-843a84316",
  "@metamask-previews/bridge-controller": "65.3.0-preview-843a84316",
  "@metamask-previews/bridge-status-controller": "65.0.1-preview-843a84316",
  "@metamask-previews/build-utils": "3.0.4-preview-843a84316",
  "@metamask-previews/chain-agnostic-permission": "1.4.0-preview-843a84316",
  "@metamask-previews/claims-controller": "0.4.2-preview-843a84316",
  "@metamask-previews/composable-controller": "12.0.0-preview-843a84316",
  "@metamask-previews/connectivity-controller": "0.1.0-preview-843a84316",
  "@metamask-previews/controller-utils": "11.18.0-preview-843a84316",
  "@metamask-previews/core-backend": "5.1.0-preview-843a84316",
  "@metamask-previews/delegation-controller": "2.0.0-preview-843a84316",
  "@metamask-previews/earn-controller": "11.1.0-preview-843a84316",
  "@metamask-previews/eip-5792-middleware": "2.1.0-preview-843a84316",
  "@metamask-previews/eip-7702-internal-rpc-middleware": "0.1.0-preview-843a84316",
  "@metamask-previews/eip1193-permission-middleware": "1.0.3-preview-843a84316",
  "@metamask-previews/ens-controller": "19.0.2-preview-843a84316",
  "@metamask-previews/error-reporting-service": "3.0.1-preview-843a84316",
  "@metamask-previews/eth-block-tracker": "15.0.1-preview-843a84316",
  "@metamask-previews/eth-json-rpc-middleware": "23.1.0-preview-843a84316",
  "@metamask-previews/eth-json-rpc-provider": "6.0.0-preview-843a84316",
  "@metamask-previews/foundryup": "1.0.1-preview-843a84316",
  "@metamask-previews/gas-fee-controller": "26.0.2-preview-843a84316",
  "@metamask-previews/gator-permissions-controller": "1.1.2-preview-843a84316",
  "@metamask-previews/json-rpc-engine": "10.2.1-preview-843a84316",
  "@metamask-previews/json-rpc-middleware-stream": "8.0.8-preview-843a84316",
  "@metamask-previews/keyring-controller": "25.1.0-preview-843a84316",
  "@metamask-previews/logging-controller": "7.0.1-preview-843a84316",
  "@metamask-previews/message-manager": "14.1.0-preview-843a84316",
  "@metamask-previews/messenger": "0.3.0-preview-843a84316",
  "@metamask-previews/multichain-account-service": "5.1.0-preview-843a84316",
  "@metamask-previews/multichain-api-middleware": "1.2.6-preview-843a84316",
  "@metamask-previews/multichain-network-controller": "3.0.2-preview-843a84316",
  "@metamask-previews/multichain-transactions-controller": "7.0.0-preview-843a84316",
  "@metamask-previews/name-controller": "9.0.0-preview-843a84316",
  "@metamask-previews/network-controller": "29.0.0-preview-843a84316",
  "@metamask-previews/network-enablement-controller": "4.1.0-preview-843a84316",
  "@metamask-previews/notification-services-controller": "21.0.0-preview-843a84316",
  "@metamask-previews/permission-controller": "12.2.0-preview-843a84316",
  "@metamask-previews/permission-log-controller": "5.0.0-preview-843a84316",
  "@metamask-previews/perps-controller": "0.0.0-preview-843a84316",
  "@metamask-previews/phishing-controller": "16.1.0-preview-843a84316",
  "@metamask-previews/polling-controller": "16.0.2-preview-843a84316",
  "@metamask-previews/preferences-controller": "22.1.0-preview-843a84316",
  "@metamask-previews/profile-metrics-controller": "3.0.0-preview-843a84316",
  "@metamask-previews/profile-sync-controller": "27.1.0-preview-843a84316",
  "@metamask-previews/ramps-controller": "6.0.0-preview-843a84316",
  "@metamask-previews/rate-limit-controller": "7.0.0-preview-843a84316",
  "@metamask-previews/remote-feature-flag-controller": "4.0.0-preview-843a84316",
  "@metamask-previews/sample-controllers": "4.0.2-preview-843a84316",
  "@metamask-previews/seedless-onboarding-controller": "7.1.0-preview-843a84316",
  "@metamask-previews/selected-network-controller": "26.0.2-preview-843a84316",
  "@metamask-previews/shield-controller": "5.0.1-preview-843a84316",
  "@metamask-previews/signature-controller": "39.0.1-preview-843a84316",
  "@metamask-previews/storage-service": "1.0.0-preview-843a84316",
  "@metamask-previews/subscription-controller": "5.4.2-preview-843a84316",
  "@metamask-previews/transaction-controller": "62.14.0-preview-843a84316",
  "@metamask-previews/transaction-pay-controller": "12.1.0-preview-843a84316",
  "@metamask-previews/user-operation-controller": "41.0.2-preview-843a84316"
}

@lwin-kyaw
Copy link
Contributor Author

@metamaskbot publish-preview

@github-actions
Copy link
Contributor

github-actions bot commented Feb 5, 2026

Preview builds have been published. See these instructions for more information about preview builds.

Expand for full list of packages and versions.
{
  "@metamask-previews/account-tree-controller": "4.0.0-preview-5ff83bad8",
  "@metamask-previews/accounts-controller": "35.0.2-preview-5ff83bad8",
  "@metamask-previews/address-book-controller": "7.0.1-preview-5ff83bad8",
  "@metamask-previews/ai-controllers": "0.0.0-preview-5ff83bad8",
  "@metamask-previews/analytics-controller": "1.0.0-preview-5ff83bad8",
  "@metamask-previews/analytics-data-regulation-controller": "0.0.0-preview-5ff83bad8",
  "@metamask-previews/announcement-controller": "8.0.0-preview-5ff83bad8",
  "@metamask-previews/app-metadata-controller": "2.0.0-preview-5ff83bad8",
  "@metamask-previews/approval-controller": "8.0.0-preview-5ff83bad8",
  "@metamask-previews/assets-controller": "0.2.0-preview-5ff83bad8",
  "@metamask-previews/assets-controllers": "99.2.0-preview-5ff83bad8",
  "@metamask-previews/base-controller": "9.0.0-preview-5ff83bad8",
  "@metamask-previews/bridge-controller": "65.3.0-preview-5ff83bad8",
  "@metamask-previews/bridge-status-controller": "65.0.1-preview-5ff83bad8",
  "@metamask-previews/build-utils": "3.0.4-preview-5ff83bad8",
  "@metamask-previews/chain-agnostic-permission": "1.4.0-preview-5ff83bad8",
  "@metamask-previews/claims-controller": "0.4.2-preview-5ff83bad8",
  "@metamask-previews/composable-controller": "12.0.0-preview-5ff83bad8",
  "@metamask-previews/connectivity-controller": "0.1.0-preview-5ff83bad8",
  "@metamask-previews/controller-utils": "11.18.0-preview-5ff83bad8",
  "@metamask-previews/core-backend": "5.1.0-preview-5ff83bad8",
  "@metamask-previews/delegation-controller": "2.0.0-preview-5ff83bad8",
  "@metamask-previews/earn-controller": "11.1.0-preview-5ff83bad8",
  "@metamask-previews/eip-5792-middleware": "2.1.0-preview-5ff83bad8",
  "@metamask-previews/eip-7702-internal-rpc-middleware": "0.1.0-preview-5ff83bad8",
  "@metamask-previews/eip1193-permission-middleware": "1.0.3-preview-5ff83bad8",
  "@metamask-previews/ens-controller": "19.0.2-preview-5ff83bad8",
  "@metamask-previews/error-reporting-service": "3.0.1-preview-5ff83bad8",
  "@metamask-previews/eth-block-tracker": "15.0.1-preview-5ff83bad8",
  "@metamask-previews/eth-json-rpc-middleware": "23.1.0-preview-5ff83bad8",
  "@metamask-previews/eth-json-rpc-provider": "6.0.0-preview-5ff83bad8",
  "@metamask-previews/foundryup": "1.0.1-preview-5ff83bad8",
  "@metamask-previews/gas-fee-controller": "26.0.2-preview-5ff83bad8",
  "@metamask-previews/gator-permissions-controller": "1.1.2-preview-5ff83bad8",
  "@metamask-previews/json-rpc-engine": "10.2.1-preview-5ff83bad8",
  "@metamask-previews/json-rpc-middleware-stream": "8.0.8-preview-5ff83bad8",
  "@metamask-previews/keyring-controller": "25.1.0-preview-5ff83bad8",
  "@metamask-previews/logging-controller": "7.0.1-preview-5ff83bad8",
  "@metamask-previews/message-manager": "14.1.0-preview-5ff83bad8",
  "@metamask-previews/messenger": "0.3.0-preview-5ff83bad8",
  "@metamask-previews/multichain-account-service": "5.1.0-preview-5ff83bad8",
  "@metamask-previews/multichain-api-middleware": "1.2.6-preview-5ff83bad8",
  "@metamask-previews/multichain-network-controller": "3.0.2-preview-5ff83bad8",
  "@metamask-previews/multichain-transactions-controller": "7.0.0-preview-5ff83bad8",
  "@metamask-previews/name-controller": "9.0.0-preview-5ff83bad8",
  "@metamask-previews/network-controller": "29.0.0-preview-5ff83bad8",
  "@metamask-previews/network-enablement-controller": "4.1.0-preview-5ff83bad8",
  "@metamask-previews/notification-services-controller": "21.0.0-preview-5ff83bad8",
  "@metamask-previews/permission-controller": "12.2.0-preview-5ff83bad8",
  "@metamask-previews/permission-log-controller": "5.0.0-preview-5ff83bad8",
  "@metamask-previews/perps-controller": "0.0.0-preview-5ff83bad8",
  "@metamask-previews/phishing-controller": "16.1.0-preview-5ff83bad8",
  "@metamask-previews/polling-controller": "16.0.2-preview-5ff83bad8",
  "@metamask-previews/preferences-controller": "22.1.0-preview-5ff83bad8",
  "@metamask-previews/profile-metrics-controller": "3.0.0-preview-5ff83bad8",
  "@metamask-previews/profile-sync-controller": "27.1.0-preview-5ff83bad8",
  "@metamask-previews/ramps-controller": "6.0.0-preview-5ff83bad8",
  "@metamask-previews/rate-limit-controller": "7.0.0-preview-5ff83bad8",
  "@metamask-previews/remote-feature-flag-controller": "4.0.0-preview-5ff83bad8",
  "@metamask-previews/sample-controllers": "4.0.2-preview-5ff83bad8",
  "@metamask-previews/seedless-onboarding-controller": "7.1.0-preview-5ff83bad8",
  "@metamask-previews/selected-network-controller": "26.0.2-preview-5ff83bad8",
  "@metamask-previews/shield-controller": "5.0.1-preview-5ff83bad8",
  "@metamask-previews/signature-controller": "39.0.1-preview-5ff83bad8",
  "@metamask-previews/storage-service": "1.0.0-preview-5ff83bad8",
  "@metamask-previews/subscription-controller": "5.4.2-preview-5ff83bad8",
  "@metamask-previews/transaction-controller": "62.14.0-preview-5ff83bad8",
  "@metamask-previews/transaction-pay-controller": "12.1.0-preview-5ff83bad8",
  "@metamask-previews/user-operation-controller": "41.0.2-preview-5ff83bad8"
}

tuna1207
tuna1207 previously approved these changes Feb 9, 2026
Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

@lwin-kyaw lwin-kyaw added this pull request to the merge queue Feb 10, 2026
Merged via the queue into main with commit 29f02a9 Feb 10, 2026
302 checks passed
@lwin-kyaw lwin-kyaw deleted the chore/improve-error-handling branch February 10, 2026 10:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-shield Transaction Shield team-shield

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants